home *** CD-ROM | disk | FTP | other *** search
/ Shareware Super Platinum 8 / Shareware Super Platinum 8.iso / mac / DIAGTOOL / X10XA2.ZIP;1 / READ.ME < prev    next >
Encoding:
Text File  |  1994-08-14  |  13.4 KB  |  362 lines
  1.                       Welcome to XA Version 2.3
  2.                       =========================
  3.  
  4. This README file contains important information about XA Version 2.3
  5. that may have been left out from the manuals. For the latest information 
  6. about XA and its accompanying programs and manuals, read this file in 
  7. its entirety. Be sure to read the file XA_203.TXT for complete details
  8. about the operation and features of XA.
  9.  
  10.  
  11.  
  12. Contents:
  13. ======================
  14.   1) Attention New Users - XA's DEMO program.
  15.   2) Attention ALL Registered Users
  16.   3) What's New in Version 2.3
  17.   4) Bug Fixes
  18.   5) Additional Information
  19.   6) Distributing the Shareware version of XA
  20.   7) Contacting the Author
  21.  
  22. 1) Attention New Users - XA's DEMO program.
  23. ================================================
  24.  
  25.   A short demonstration program has been added to show new users the
  26.   capabilities of XA. First, copy ALL of the files from the distribution
  27.   floppy (or archive) to the directory where you normally keep your X10
  28.   files. 
  29.  
  30.   Next, type one of the following command at the DOS prompt:
  31.  
  32.       DEMO    (for color monitors)  or,
  33.       DEMO_BW (for monochrome monitors.
  34.  
  35.   Finally, you should print XA's documentation to your printer.  
  36.   At the DOS prompt, type: 
  37.  
  38.       PRINT XA_203.TXT            (to use the DOS print spooler)
  39.                                              - or -
  40.       TYPE XA_203.TXT > LPT1      (to bypass the print spooler and)
  41.                                   (print directly to your printer)
  42.  
  43.  
  44.  
  45. 2) Attention ALL Registered Users:
  46. ================================================
  47.  
  48.   If you have already received the number of upgrades as specified in
  49.   the registration agreement, you may upgrade to the latest version of 
  50.   XA for a very nominal fee.  Please fill out the registration form
  51.   (REGISTER.TXT) and mail it with the specified payment to the address 
  52.   listed below. 
  53.  
  54.  
  55.  
  56. 3) What's New in Version 2.1 through 2.3
  57. ================================================
  58.  
  59.   * Added "Every 'n' Days" tokens
  60.     -------------------------------------------------------------
  61.     
  62.     This feature allows you to program events that need to be repeated
  63.     every several days, for example, an irrigation system that you
  64.     want activated every 5 days. This is hard to accomplish using day
  65.     tokens like SUN, FRI, etc. because these days will change from week
  66.     to week. XA will choose the correct days for each week automatically.
  67.  
  68.  
  69.   * Added "+u" command line option      
  70.     -------------------------------------------------------------
  71.  
  72.     This option forces XA to perform a complete event upload rather than
  73.     rely on the schedule information stored in the X10.DAT file. This
  74.     option may be necessary if other X10 shareware programs are used
  75.     that don't maintain data in the X10.DAT file. This option might
  76.     also be used when performing a powerfail recovery - it guarantees that
  77.     XA will restore the states of all programmed modules.
  78.     
  79.     
  80.   * Added "polling" mode communications (non-interrupt driven).
  81.     -------------------------------------------------------------
  82.  
  83.     - Polling mode (i=0, IRQ 0) for CP-290 communications was removed
  84.       from V 2.0.  It has been added in V.2.1. of XA.  
  85.     - Also, FINDX10 has been modified to handle polling. 
  86.     - Validated additional checksums in CP-290 messages to ensure 
  87.       communications are correct.
  88.  
  89.     - Special Note: Use of the "FAST" token for multiple commands may
  90.       may not work with polling mode. You should use interrupt-driven
  91.       communications (IRQ, i=xxx) when FAST is required.
  92.  
  93.   * Modified syntax for the "THRU" token.
  94.     -------------------------------------------------------------
  95.  
  96.     - The syntax for THRU has been modified to allow for an optional
  97.       DATE token. 
  98.   
  99.       Syntax:  DATE 11/25/1993 THRU DATE 1/1/1994
  100.                                     ^^^^
  101.  
  102.     - This allows a more consistent approach to DEFINING special events. 
  103.  
  104.         DEFINE NEW_YEARS DATE 1/1/1994
  105.         DEFINE THANKSGIVING DATE 11/26/1994
  106.         DEFINE CHRISTMAS DATE 12/25/1994
  107.  
  108.         THANKSGIVING THRU NEW_YEARS EXCEPT CHRISTMAS A1 ON SUNSET
  109.  
  110.  
  111.   * Added DEMO files to show new users the capabilities of XA.
  112.     -------------------------------------------------------------
  113.  
  114.     - To run, type DEMO when using a color monitor,
  115.               type DEMO_BW for a monochrome monitor.
  116.  
  117.  
  118.   * Enable VIDEO highlighting
  119.     -------------------------------------------------------------
  120.  
  121.     VIDEO highlighting has been enabled in the shareware version. This
  122.     feature will allow you to tell at a glance whether an event based on
  123.     certain date criteria is downloaded to the CP-290. When using the
  124.     DATE/THRU/EXCEPT tokens, XA will highlight the command using the
  125.     VIDEO4 colors if the event is downloaded to the CP-290. If the event
  126.     does not fall within the programmed range, then the VIDEO2 colors
  127.     will be used. 
  128.  
  129.  
  130. 4) Bug fixes
  131. ================================================
  132.  
  133. The following problems have been reported with XA Ver. 2.x.  
  134.  
  135.   * "CLEAR EVENT xxx" did not work.
  136.  
  137.         This bug has been fixed in V2.3
  138.  
  139.  
  140.   * The files "DEMO.CMD", "DEMO_BW.CMD", and "USAGE.XA" are READ-ONLY
  141.     files. Please do not attempt to modify these files!
  142.  
  143.  
  144.   * On IBM-PC/XT's, XA might sometimes disable interrupts upon exiting 
  145.     which caused certain IBM-PC/XT compatible machines to "lock up". 
  146.  
  147.         Fixed in Version 2.2b.
  148.  
  149.   * If an event was programmed to occur on DATE 1/1, and a time OFFSET 
  150.     causes the event to wrap into the next day, XA would adjust the time
  151.     but not the date. Therefore, the event would still occur on 1/1. 
  152.     XA will adjust all DATES (and THRU date - if programmed) accordingly.
  153.  
  154.         Fixed in Version 2.2a.
  155.  
  156.  
  157.   * Negative LONGITUDES, LATITUDES, and TIMEZONES would cause XA
  158.     to seemingly "lock up". 
  159.  
  160.         Fixed in Version 2.2
  161.  
  162.  
  163.   * XA.RPT "Cmd" and "Mode" columns were off by 1.
  164.     -------------------------------------------------------------
  165.  
  166.         Fixed in Version 2.1
  167.  
  168.  
  169.   * XA.RPT - Long module names would cause event numbers to be misaligned
  170.     ---------------------------------------------------------------------
  171.  
  172.     Fixed in Version 2.2
  173.  
  174.  
  175.   * ALL_UNITS_OFF was not parsed correctly.
  176.     -------------------------------------------------------------
  177.  
  178.     XA ignored any events or commands that used this token.
  179.  
  180.     Fixed in Version 2.1a
  181.  
  182.  
  183.   * ERASE in XA.INI causes XA.EXE to abort.
  184.     -------------------------------------------------------------
  185.  
  186.     Do not put ERASE token in XA.INI. When ERASE is parsed, XA attempts
  187.     to send a command to the CP-290 prior to the proper communication
  188.     channel being opened.  ERASE was not intended to be placed in XA.INI.
  189.     Doing so would force all events in the CP-290 to be cleared whenever
  190.     XA was invoked.
  191.  
  192.     No direct commands, events, or other tokens that may communicate with
  193.     the CP-290 will be sent to the CP-290 while parsing the XA.INI file.
  194.  
  195.  
  196.   * Monitor causes events to be downloaded.
  197.     -------------------------------------------------------------
  198.  
  199.     This occurs when invoking the monitor function by using the "+m"
  200.     command line parameter, and the XA.INI includes the XACMD token.  The
  201.     solution is to invoke monitoring as follows:
  202.  
  203.           XA "monitor",
  204.      not: XA +m
  205.  
  206.     The manual incorrectly stated that you could add the "-e" option to
  207.     prevent parsing of the command file. Beginning with XA 2.00, the "-e"
  208.     option ignores all communication with the CP-290. This allows you to
  209.     verify a command file before storing its data to the CP-290.
  210.  
  211.  
  212.   * F4 ON SUNDAY SUNSET EXCEPT DATE 11/12/1996
  213.        uses EVERYDAY instead of SUNDAY
  214.     -------------------------------------------------------------
  215.  
  216.     Fixed in Version 2.1.
  217.  
  218.  
  219.  
  220.   * Testing a SUNRISE or SUNSET time may not evaluate correctly:
  221.     -------------------------------------------------------------
  222.    
  223.     For example:
  224.       IF (SUNRISE > TIME 5:45 AM)    # Sunrise is 6:55 am
  225.  
  226.     XA was only calculating SUNRISE or SUNSET times when they appeared in
  227.     an EVENT statement (A1 ON MONDAY SUNRISE). If a CONDITIONAL statement
  228.     tested SUNRISE/SET before any events were programmed in the command
  229.     file, the resulting SUNRISE/SET time was midnight (0). If the
  230.     CONDITIONAL statement appeared after an event statement, the
  231.     SUNRISE/SET time would be correct.
  232.  
  233.     Fixed in Version 2.1.
  234.  
  235.  
  236.   * XA.RPT file did not reflect proper modules.
  237.     -------------------------------------------------------------
  238.  
  239.     Using REPORT1, if multiple modules on the same housecode but in
  240.     differents unit ranges (1...8) and (9...16) are programmed for the
  241.     same event, only modules in the first range (1...8) are reported.
  242.     Those modules in the upper range are reported incorrectly as modules
  243.     in the range (1...8).
  244.  
  245.     For example:
  246.       C4 C10 ON EVERYDAY SUNRISE
  247.  
  248.       REPORT1 will show:
  249.           6:15am ON    C4                                      (1)*
  250.           6:15am ON    C4                                      (1)*
  251.  
  252.       instead of:
  253.           6:15am ON    C4                                      (1)*
  254.           6:15am ON    C10                                     (1)*
  255.  
  256.     Fixed in Version 2.1.
  257.  
  258.  
  259.   * Use of the "UNIT ALL" tokens did not program all units for the
  260.     selected housecode. 
  261.     -------------------------------------------------------------
  262.  
  263.     Fixed in Version 2.1.
  264.  
  265.  
  266.   * The following statement would not parse the date range correctly:
  267.     THANKSGIVING THRU NEW_YEARS XMAS_LIGHTS ON SUNSET
  268.     -------------------------------------------------------------
  269.  
  270.     XA did not convert the DEFINE for NEW_YEARS (or any other definition 
  271.     for the "THRU" token) properly.
  272.  
  273.     Fixed in Version 2.1.
  274.  
  275.  
  276.   * AUTOEXEC.BAT was not included on the floppy (or zip files)
  277.     -------------------------------------------------------------
  278.  
  279.     This file is now included, but it is called AUTOEXC.BAT in order
  280.     to avoid overwriting a users original AUTOEXEC.BAT.
  281.  
  282.  
  283. 5) Additional Information
  284. ================================================
  285.  
  286.   * Warning Messages:
  287.     -------------------------------------------------------------
  288.  
  289.     XA will display the following message when it encounters a token it
  290.     doesn't recognize:
  291.  
  292.         ---ERROR--- Invalid expression in statement:
  293.         (...statement displayed here...)
  294.  
  295.     You must edit the file where this warning was encountered. XA always 
  296.     displays the directory and name of the file being parsed.
  297.  
  298.     Note: If this is the SHAREWARE version of XA, see the next section for
  299.     tokens that are NOT supported in this release.
  300.  
  301.  
  302.   * Shareware Version:
  303.     -------------------------------------------------------------
  304.  
  305.     The following tokens are NOT supported in the SHAREWARE version of XA.
  306.       - IF, ELSE, ENDIF
  307.       - INPORT, OUTPORT
  308.       - Arithmetic Operators (+, -, *, /, % (modulus) )
  309.       - Logical Operators (AND, &&, &, OR, ||, |)
  310.       - Relational Operators (=, <, >, <=, >=, ==)
  311.  
  312.     As a result, the sample command files (PHONE.CMD, XMAS.CMD, and 
  313.     JOYSTICK.CMD) will report errors when they execute. These files
  314.     are intended to demonstrate various script files you may create 
  315.     with the registered version of XA.
  316.  
  317.     You must register XA with the author to have these tokens enabled.
  318.     Upon registration, you will receive a registered version and printed
  319.     User's Guide. Please fill out the form "REGISTER.TXT".
  320.  
  321.  
  322.   * Using XA with Windows:
  323.     ------------------------------------------------------------- 
  324.     
  325.     The following files have been included to help you run XA within 
  326.     Windows:
  327.  
  328.     - xa_event.pif  - PIF file for downloading contents of XA.CMD to CP-290
  329.     - xa_mon.pif    - PIF file for monitoring events and commands.
  330.     - xa_power.pif  - PIF file for power fail recovery.
  331.  
  332.     Place these files in your Windows subdirectory (normally C:\WINDOWS). 
  333.     These PIF files expect XA to be in the C:\X10 directory. If this is not
  334.     the case, use the Windows PIF editor to modify the settings. See your 
  335.     Windows User's Guide for complete details. Also, see "Appendix C" in
  336.     XA_203.TXT for other important details regarding XA and COM ports.
  337.  
  338.     In some cases, you may notice that some video messages are not displayed
  339.     correctly. Use the Windows PIF editor to change the "Display Usage" from
  340.    "Windowed" to "Full Screen". All messages should be restored properly.
  341.  
  342. 6) Distributing the Shareware version of XA
  343. ================================================
  344.  
  345.   You are encouraged to distribute the SHAREWARE version of XA to your
  346.   friends, BBS's, or online services. Please use the pre-zipped
  347.   SHAREWARE files that are located in the "SHARWARE" directory of this
  348.   distribution floppy (if applicable). 
  349.  
  350.   Please remember, it is a violation of copyright laws to distribute
  351.   "REGISTERED" versions of XA without permission from the author.
  352.  
  353.  
  354. 7) Contacting the Author
  355. ================================================
  356.  
  357.   ⁄ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒø
  358.   ≥ Bruce Christensen                   CompuServe     :  73201,1531   ≥
  359.   ≥ 6594 Hudson Ave.                    Prodigy ID     :  MHNC39A      ≥
  360.   ≥ Mentor, OH. 44060-4545              America On-Line:  AuggieBen    ≥
  361.   ¿ƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒƒŸ
  362.